home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / pascal / vmix267.zip / VMIX.DOC < prev    next >
Text File  |  1991-12-10  |  103KB  |  1,628 lines

  1.                                                   _______
  2.                                              ____|__     |               (tm)
  3.                                           --|       |    |-------------------
  4.                                             |   ____|__  |  Association of
  5.                tm                           |  |       |_|  Shareware
  6.        VMiX 386   Version 2.67              |__|   o   |    Professionals
  7.        -----------------------            -----|   |   |---------------------
  8.                                                |___|___|    MEMBER
  9.        Copyright (c) 1985-1991
  10.  
  11.      Commercial Software Associates
  12.           Post Office Box  36             BBS    (714)  720-1139 (24 Hrs.)
  13.     Corona del Mar, California  92625    VOICE   (714)  720-1214 (8-6pm PDT)
  14.  
  15.       _______________________________________________________________
  16.      |                                                               |
  17.      | WHAT IS VMiX?                                                 |
  18.      | -------------                                                 |
  19.      |                                                               |
  20.      |      VMiX is a multitasking and multiuser environment for     |
  21.      |      IBM PC's and PS/2's (PC, XT, AT, PS/2) compatibles.      |
  22.      |                                                               |
  23.      |      Version 2.67 configures itself to your processor. If you |
  24.      |      have an 8088 or 8086, then your applications must share  |
  25.      |      the up to 576 Kbytes available after VMiX loads in low   |
  26.      |      memory.                                                  |
  27.      |                                                               |
  28.      |      If you have an 80286, then VMiX can multitask in low     |
  29.      |      conventional memory or it can task switch applications   |
  30.      |      to extended memory.  VMiX can not execute tasks in 286   |
  31.      |      extended memory.  Swapped tasks can be swapped back      |
  32.      |      from 286 extended memory automatically for a timeslice   |
  33.      |      of the processing or they can remain suspended until     |
  34.      |      reactivated by the user.                                 |
  35.      |                                                               |
  36.      |      If you have an 80386/486, VMiX will multitask in extend- |
  37.      |      ed memory.  It will execute each task in virtual 8086    |
  38.      |      mode, with protected mode pagging, virtualized video and |
  39.      |      keyboard, mapping a new 640 Kbytes to each new task.     |
  40.      |      With DOS 5.0 relocated to high memory, all 640Kb can be  |
  41.      |      used by each application.                                |
  42.      |                                                               |
  43.      |      Multitasking is supported at the console, in windows or  |
  44.      |      full screen(s).  All tasks execute concurrently, at the  |
  45.      |      console, remote terminal, or at the console but running  |
  46.      |      at a remote VMiX server.  Since the console video display|
  47.      |      can be virtualized, you can switch between screens (each |
  48.      |      with multiple windows).  If you do not like windows at   |
  49.      |      your console or flipping screens, you can choose to use  |
  50.      |      terminals or PC's attached to the COMM ports.            |
  51.      |                                                               |
  52.      |      The VMiX environment uses the best from DOS and UNIX     |
  53.      |      in its implementation of the user control shell and      |
  54.      |      multitasking.  The user has a choice of 2 user interfa-  |
  55.      |      ces:  the VMiX shell, which can talk to the DOS shell    |
  56.      |      (you get both sets of commands), or the VMiX pull-down   |
  57.      |      menus interface which is a multi-threaded environment.   |
  58.      |_______________________________________________________________|
  59.  
  60.       _______________________________________________________________
  61.      | Cont'd                                                        |
  62.      | ------                                                        |
  63.      |                                                               |
  64.      |      Applications that do not write directly to the video,    |
  65.      |      will display correctly at a terminal in all VMiX modes.  |
  66.      |      Applications that write directly to the video, can be    |
  67.      |      virtualized at the 386 console or at terminals only when |
  68.      |      using VMiX in 386 mode with ANSI terminal emulation.     |
  69.      |      A remote console utility can be used in other modes to   |
  70.      |      handle direct video writes.                              |
  71.      |                                                               |
  72.      |      VMiX.INI is a text autoconfigure file that allows start- |
  73.      |      up scripts, remote login passwords, and remote login     |
  74.      |      scripts to be specified by the system administrator.     |
  75.      |                                                               |
  76.      |      VMiX is compatible with DOS 3.1 through 5.00             |
  77.      |_______________________________________________________________|
  78.  
  79.       _______________________________________________________________
  80.      |                                                               |
  81.      | WHAT IS AHEAD FOR VMiX?                                       |
  82.      |                                                               |
  83.      |            Virtual 386 DOS file buffers to avoid DOS file     |
  84.      |            read/write conflicts with multiple file I/O.       |
  85.      |            Compatibility with other extended memory software. |
  86.      |            A DPMI interface.                                  |
  87.      |            A distributed file system.                         |
  88.      |_______________________________________________________________|
  89.  
  90.       _______________________________________________________________
  91.      |                                                               |
  92.      | WHAT IS UNIQUE ABOUT VMiX?                                    |
  93.      | --------------------------                                    |
  94.      |                                                               |
  95.      |     VMiX is supported shareware.  In the rapidly developing   |
  96.      |     multitasking market, VMiX has undergone over 32 new       |
  97.      |     releases in the last 6 years, each with new and enhanced  |
  98.      |     features.                                                 |
  99.      |                                                               |
  100.      |     VMiX is A COMMAND LINE MULTITASKER or you can make use    |
  101.      |     of its pull-down menus shell.                             |
  102.      |                                                               |
  103.      |     VMiX provides an easy to install and operate environment  |
  104.      |     that can be used to multitask DOS on 8086 computers.  It  |
  105.      |     can also be used to task switch applications to extended  |
  106.      |     memory on 80286 AT's.  VMiX's native environment is the   |
  107.      |     80386, on those computers, use of extended memory and     |
  108.      |     emulated expanded memory is automatic.                    |
  109.      |                                                               |
  110.      |     VMiX allows 2 or more computers running VMiX to be linked |
  111.      |     as a distributed processing environment, where different  |
  112.      |     client machines can execute programs in other servers.    |
  113.      |     VMiX also provides remote modem access to any of your     |
  114.      |     multiuser PC hosts.                                       |                                                |
  115.      |                                                               |
  116.      |     If you can execute your applications from DOS, they are   |
  117.      |     already installed for VMiX.  VMiX does not use PIF or     |
  118.      |     other types of application configuration files.           |
  119.      |                                                               |
  120.      |                                                               |
  121.      |                    APPLICATION SCREEN HANDLING                |
  122.      |                                                               |
  123.      |                    do           do -W           'terminal'    |
  124.      |                  -------------------------------------------- |
  125.      |     8086 Mode      Text Mode    Text Mode       Text Mode     |
  126.      |                    Graphics     Mix Txt/Grphcs      -         |
  127.      |                    BIOS Video   BIOS Video      BIOS Video    |
  128.      |                        -            -        ** Direct Video  |
  129.      |                                                               |
  130.      |     286 Mode       Text Mode    Text Mode       Text Mode     |
  131.      |                    Graphics     Mix Txt/Grphcs      -         |
  132.      |                    BIOS Video   BIOS Video      BIOS Video    |
  133.      |                        -            -        ** Direct Video  |
  134.      |                                                               |
  135.      |     386 Mode       Text Mode    Text Mode       Text Mode     |
  136.      |                    Graphics     Mix Txt/Grphcs      -         |
  137.      |                    BIOS Video   BIOS Video      BIOS Video    |
  138.      |                    Direct Video Direct Video    Direct Video  |
  139.      |                                                               |
  140.      |  ** VMiX will handle programs executed at a terminal (COMM    |
  141.      |     port) that do direct video screen writes only in 386 mode,|
  142.      |     in other modes you will need to use VMiX in conjunction   |
  143.      |     with a program like 'Remote Console'tm (see below).       |
  144.      |                                                               |
  145.      |     The VMiX interface is layered, to protect the casual user |
  146.      |     who just wants to get maximum utility and does not need   |
  147.      |     or wants to learn the full system.  For the advanced user,|
  148.      |     VMiX provides an internal 'debug' shell, which can be     |
  149.      |     coupled with a DOS debugger, as a concurrently executing  |
  150.      |     VMiX task, to examine other live applications.            |
  151.      |_______________________________________________________________|
  152.  
  153.       _______________________________________________________________
  154.      |                                                               |
  155.      | HOW TO INSTALL MY APPLICATIONS?                               |
  156.      | -------------------------------                               |
  157.      |                                                               |
  158.      |     If you can execute your applications from DOS, they       |
  159.      |     are already installed for VMiX.  VMiX does not use PIF    |
  160.      |     or other types of application configuration files.        |
  161.      |                                                               |
  162.      |     Applications that write directly to the screen can        |
  163.      |     co-exist with other applications at the console, but      |
  164.      |     will not display properly when running VMiX in non-386    |
  165.      |     computers.  On 286 and 8086 PCs, applications that write  |
  166.      |     directly to video can bleed-through to other tasks, also  |
  167.      |     running at the console, and they will not be able to be   |
  168.      |     displayed at a remote terminal.  On 286 and 8086 PCs,     |
  169.      |     you might be able to get around this problem by setting   |
  170.      |     a different video page with VMiX, before starting the     |
  171.      |     application.                                              |
  172.      |_______________________________________________________________|
  173.  
  174.       _______________________________________________________________
  175.      |                                                               |
  176.      | HOW MUCH MEMORY WILL REMAIN AFTER VMiX IS INSTALLED?          |
  177.      | ----------------------------------------------------          |
  178.      |                                                               |
  179.      |     On a 640Kb memory 8088 PC or 80286 AT with DOS 5.0 and    |
  180.      |     no low memory installed TSR's, there will remain 470Kb    |
  181.      |     to 576Kb of memory for applications.  VMiX can be told    |
  182.      |     to fill memory above 640Kb with 96Kb of additional        |
  183.      |     program space, in alphanumeric text modes on EGA/VGA      |
  184.      |     equipped systems. On the 80386, each task gets it's own   |
  185.      |     640Kb from your extended memory pool.                     |
  186.      |_______________________________________________________________|
  187.  
  188.       _______________________________________________________________
  189.      |                                                               |
  190.      | HOW DO I VALIDATE THAT VMIX IS WORKING CORRECTLY?             |
  191.      | -------------------------------------------------             |
  192.      |                                                               |
  193.      |     To test VMiX, we recommend that you perform the two       |
  194.      |     tests below:                                              |
  195.      |                                                               |
  196.      |     TEST 1: Validates that VMiX itself is working correctly.  |
  197.      |                                                               |
  198.      |     invoke VMiX as follows:   (from the directory where you   |
  199.      |                                copied VM_BOOT.EXE          )  |
  200.      |                                                               |
  201.      | VM_BOOT do /set                                               |
  202.      |                                                               |
  203.      |             and PRESS <ENTER>                                 |
  204.      |             This will start 2 tasks:                          |
  205.      |                                      the root shell or main   |
  206.      |                                      window, where the key-   |
  207.      |                                      board will remain unless |
  208.      |                                      you press Shift-Tab, and |
  209.      |                                      a VMiX debugger task     |
  210.      |                                      displaying information   |
  211.      |                                      about the 'set' command. |
  212.      |             If all windows display activity, the TEST PASSED. |
  213.      |             From the root window type 'quit' and press <ENTER>|
  214.      |             to exit VMiX.                                     |
  215.      |                                                               |
  216.      |_______________________________________________________________|
  217.  
  218.       _______________________________________________________________
  219.      | Cont'd                                                        |
  220.      | ------                                                        |
  221.      |                                                               |
  222.      |     TEST 2: Validates that VMiX, your version of DOS, and     |
  223.      |             your system's ROM BIOS, all get along fine.       |
  224.      |                                                               |
  225.      |     invoke VMiX as follows:   (from the directory where you   |
  226.      |                                copied VM_BOOT.EXE          )  |
  227.      |                                                               |
  228.      | VM_BOOT do dir c: /type c:\autoexec.bat                       |
  229.      |                                                               |
  230.      |             and PRESS <ENTER>                                 |
  231.      |             This will start 2 tasks:                          |
  232.      |                                      the root shell or main   |
  233.      |                                      window, displaying your  |
  234.      |                                      autoexec.bat file, where |
  235.      |                                      the keyboard will remain,|
  236.      |                                      and another task doing a |
  237.      |                                      directory.               |
  238.      |             If all windows display activity, the TEST PASSED. |
  239.      |             From the root window type 'quit' and press <ENTER>|
  240.      |             to exit VMiX.                                     |
  241.      |_______________________________________________________________|
  242.  
  243.       _______________________________________________________________
  244.      |                                                               |
  245.      | HOW TO INSTALL VMiX?                                          |
  246.      | --------------------                                          |
  247.      |                                                               |
  248.      |     For more detailed information, see 'General Instructions',|
  249.      |     The Easy Way' and 'The Advanced Way' given below.         |
  250.      |                                                               |
  251.      |                                                               |
  252.      |     VMiX is easy to install.  Simply copy the executable      |
  253.      |     files in the VMiX archive to your directory, include the  |
  254.      |     install directory in your PATH, remove other extended     |
  255.      |     memory managers from your CONFIG.SYS and execute the boot |
  256.      |     module VM_BOOT.EXE                                        |
  257.      |                                                               |
  258.      |     If VMiX fails to start correctly on your computer, you    |
  259.      |     can use several startup options.                          |
  260.      |                                                               |
  261.      |     'VM_BOOT 8086' will force real mode on 80286/386/486 PC's.|
  262.      |                                                               |
  263.      |     'VM_BOOT 286'  will force 80286 VMiX mode on 80386/486    |
  264.      |                    computers.                                 |
  265.      |                                                               |
  266.      |     'VM_BOOT low'  or VM_BOOT low 286' will inhibit relocation|
  267.      |                    of portions of VMiX to extended memory.    |
  268.      |                                                               |
  269.      |     'VM_BOOT ems=ffff' will inhibit VMiX from relocating to   |
  270.      |                    any upper memory block.                    |
  271.      |                                                               |
  272.      |     Some EGA/VGA's will display no cursor or what appears to  |
  273.      |     be a broken cursor when Shift-Tab is pressed to switch    |
  274.      |     tasks.  To correct this, start VMiX with the command line |
  275.      |                                                               |
  276.      |     'VM_BOOT egacur'                                          |
  277.      |                                                               |
  278.      |     Use of these options might allow VMiX to execute in your  |
  279.      |     environment.                                              |
  280.      |                                                               |
  281.      |     REFER TO THE SECTION BELOW for common startup problems.   |
  282.      |                                                               |
  283.      |     You can customize how VMiX starts-up by including other   |
  284.      |     command arguments in the VM_BOOT command line, from DOS.  |
  285.      |_______________________________________________________________|
  286.  
  287.       _______________________________________________________________
  288.      |                                                               |
  289.      | RECOMMENDED CONFIG.SYS (file contents for DOS 5.0)            |
  290.      | ----------------------                                        |
  291.      |                                                               |
  292.      |     SHELL   = C:\COMMAND.COM /P /E:512                        |
  293.      |     FCBS    = 2,0        (Optional)                           |
  294.      |     STACKS  = 9,192      (Do not set to 0,0)                  |
  295.      |     DOS     = HIGH       (Do not use the UMB option!)         |
  296.      |     BUFFERS = 15                                              |
  297.      |     FILES   = 20         (More than 20, if apps need it.)     |
  298.      |     LASTDRIVE = H        (Optional, set your last drive here) |
  299.      |     DEVICE  = HIMEM.SYS                                       |
  300.      |     DEVICE  = MOUSE.SYS /2   (Your mouse driver, if any.)     |
  301.      |_______________________________________________________________|
  302.  
  303.       _______________________________________________________________
  304.      |                                                               |
  305.      | G E N E R A L    I N S T R U C T I O N S                      |
  306.      |                                                               |
  307.      |  1)   BEFORE USING VMiX 386, you must copy                    |
  308.      |       the self-extracting archive from the                    |
  309.      |       Shipping  Diskette  to  your  system                    |
  310.      |       hard disk (or 1.2+ MBYTE floppy).                       |
  311.      |                                                               |
  312.      |       NEVER  use  the Shipping Diskette to                    |
  313.      |       actually  run  VMiX  386.   Use  the                    |
  314.      |       copies  that you  have made  from it                    |
  315.      |       and keep  the Master Disk in a cool,                    |
  316.      |       secure place.                                           |
  317.      |                                                               |
  318.      |       STEP 1: Insert the Shipping Diskette in Drive A:        |
  319.      |                                                               |
  320.      |       STEP 2: Make a VMiX subdirectory in your hard disk.     |
  321.      |                                                               |
  322.      |               md \VMiX                                        |
  323.      |               cd \VMiX                                        |
  324.      |                                                               |
  325.      |                                                               |
  326.      |       STEP 3: Copy A:*.* to C:\VMiX                           |
  327.      |                                                               |
  328.      |       STEP 4: Execute the archive to extract the files.       |
  329.      |                                                               |
  330.      |       STEP 5: Verify that the CONFIG.SYS file,  in your       |
  331.      |               boot directory,  includes the following 2       |
  332.      |               lines and no DEVICE= lines that invoke an       |
  333.      |               extended memory  driver  like 386MAX.SYS,       |
  334.      |               QEMM.SYS,   EMM386.SYS  or  SMARTDRV.SYS.       |
  335.      |               Also  verify that  you  are NOT  using an       |
  336.      |               ANSI.SYS driver.                                |
  337.      |                                                               |
  338.      |               BUFFERS = 15         (or more)                  |
  339.      |               FILES = 20           (or more)                  |
  340.      |                                                               |
  341.      |                                                               |
  342.      |  2)   TO EXECUTE THE  VMiX 386 PROGRAM you                    |
  343.      |       will need   MS-DOS  Version 3.10  or                    |
  344.      |       above, and 256Kb of memory.  A color                    |
  345.      |       graphics  card,  VGA  is recommended                    |
  346.      |       for  the console  display.                              |
  347.      |                                                               |
  348.      |       If  you have  a Monochrome  Adapter,                    |
  349.      |       VMiX will sense it.                                     |
  350.      |                                                               |
  351.      |       VMiX 386 does not need to operate in                    |
  352.      |       protected mode in all configurations.                   |
  353.      |       It  will  execute  properly  in PC's                    |
  354.      |       with 8088 processors.                                   |
  355.      |                                                               |
  356.      |       Start VMiX by typing:                                   |
  357.      |                                                               |
  358.      |       C> VM_BOOT <ENTER>                                      |
  359.      |                                                               |
  360.      |       After VMiX starts, typing a '?' will                    |
  361.      |       display all the available commands.                     |
  362.      |_______________________________________________________________|
  363.  
  364.       _______________________________________________________________
  365.      | Cont'd                                                        |
  366.      | ------                                                        |
  367.      |                                                               |
  368.      |       TYPE:                  debug <ENTER>                    |
  369.      |       (NOTE the prompt changes to: -  )                       |
  370.      |                                                               |
  371.      |       Next, try  'set' or  'exam' and VMiX                    |
  372.      |       VMiX  will  display  how to complete                    |
  373.      |       the  command.  VMiX will  prompt for                    |
  374.      |       most  command line  arguments,   not                    |
  375.      |       included in the command line:                           |
  376.      |                                                               |
  377.      |       TYPE:            set video -m<ENTER>                    |
  378.      |       to see the video modes available,                       |
  379.      |                                                               |
  380.      |       TYPE:             set term -t<ENTER>                    |
  381.      |       to see the terminals supported.                         |
  382.      |                                                               |
  383.      |       From the  -  prompt, type  'quit' to                    |
  384.      |       to return to the root shell.                            |
  385.      |                                                               |
  386.      | 3)    TO START VMiX 386 WITH THE PULL-DOWN                    |
  387.      |       MENUS INTERFACE:                                        |
  388.      |                                                               |
  389.      |       Set the PATH for the VMiX utilities:                    |
  390.      |                                                               |
  391.      |       C> PATH = C:\VMiX <ENTER>                               |
  392.      |                                                               |
  393.      |       Start VMiX by typing:                                   |
  394.      |                                                               |
  395.      |       C> VM_BOOT VW <ENTER>                                   |
  396.      |                                                               |
  397.      |       When VMiX starts, the top screen line                   |
  398.      |       will  display  the  available  menus.                   |
  399.      |       Move to the desired menu  by pressing                   |
  400.      |       right  or  left-arrow keys.  Select a                   |
  401.      |       menu by pressing the  down-arrow key,                   |
  402.      |       <ENTER>, or by typing the CAPITALIZED                   |
  403.      |       letter of the menu name.                                |
  404.      |                                                               |
  405.      |       Select  a menu option by first moving                   | 
  406.      |       to the  desired item  with  the down-                   |
  407.      |       arrow  and  press  <ENTER> to execute                   |
  408.      |       the option.  Exit from the VW utility                   |
  409.      |       or pull-down menu with the <Esc> key.                   |
  410.      |                                                               |
  411.      |       Pull-down options that display an ->,                   |
  412.      |       indicate  an  additional   pull-down,                   |
  413.      |       reachable  by pressing <ENTER> or the                   |
  414.      |       right-arrow key.                                        |
  415.      |                                                               |
  416.      |       When  using a  NON VT-100 terminal to                   |
  417.      |       run VW.EXE,  first  use  <Ctrl><F> to                   |
  418.      |       enable function  key  emulation, then                   |
  419.      |       <Ctrl><L>  becomes right arrow, back-                   |
  420.      |       space  becomes left-arrow,  <Ctrl><J>                   |
  421.      |       and  <Ctrl><K>  will  act as down and                   |
  422.      |       up-arrow.                                               |
  423.      |                                                               |
  424.      |       Pressing the [Home] key, while in VW,                   |
  425.      |       will cause a  repaint of the VW menu.                   |
  426.      |_______________________________________________________________|
  427.  
  428.       _______________________________________________________________
  429.      |                                                               |
  430.      | THE EASY WAY TO START VMiX (With Pull-down Menus)             |
  431.      | --------------------------                                    |
  432.      |                                                               |
  433.      |  C:\VMIX> PATH = C:\;C:\VMIX; (all your apps .EXE paths here) |
  434.      |                                                               |
  435.      |  C:\VMIX> VM_BOOT egacur/set re -x/set vi -s/set sys -c/vw    |
  436.      |                                                               |
  437.      |                                                               |
  438.      |  Configuration explanation:                                   |
  439.      |                                                               |
  440.      |  Before you start VMiX, set your DOS path for all the antici- |
  441.      |  pated executables you wish to multitask.                     |
  442.      |                                                               |
  443.      |  'egacur'      Optional, makes sure the cursor displays OK.   |
  444.      |                                                               |
  445.      |  'set re -x'   NO multiusers at your COMM ports, disables     |
  446.      |                remote logins, so as not to interfere with     |
  447.      |                what you already have connected at the ports.  |
  448.      |                                                               |
  449.      |                If you want multiusers, delete this command.   |
  450.      |                                                               |
  451.      |  'set vi -s'   Display a status line, so you can determine the|
  452.      |                name of the foreground task (where the kbd is).|
  453.      |                                                               |
  454.      |  'set sys -c'  Enable a software cursor, so you can see where |
  455.      |                you are, even if another tasks disables the    |
  456.      |                hardware cursor or your task has gone to sleep.|
  457.      |                                                               |
  458.      |  'vw'          Run the Pull-Down Menu shell, from where to    |
  459.      |                start other VMiX DOS shells.  With VW, you will|
  460.      |                usually start a new shell, from where to start |
  461.      |                your multitasking application (or you can      |
  462.      |                launch your applications directly).            |
  463.      |                                                               |
  464.      |                                                               |
  465.      |  Alternative use of VMiX.INI:                                 |
  466.      |                                                               |
  467.      |  VMiX.INI is a text script file that is processed by the      |
  468.      |  utility VSETUP.EXE                                           |
  469.      |                                                               |
  470.      |  Edit the above configuration commands into your VMiX.INI     |
  471.      |  file:                                                        |
  472.      |                                                               |
  473.      |  [startup]                                                    |
  474.      |  set re -x/set vi -s/set sys -c/vw                            |
  475.      |                                                               |
  476.      |                                                               |
  477.      |  C:\VMIX> PATH = C:\;C:\VMIX; (all your apps .EXE paths here) |
  478.      |                                                               |
  479.      |  C:\VMIX> VM_BOOT egacur/vsetup                               |
  480.      |_______________________________________________________________|
  481.  
  482.       _______________________________________________________________
  483.      |                                                               |
  484.      | THE ADVANCED WAY TO START VMiX (Command line multitasker)     |
  485.      | ------------------------------                                |
  486.      |                                                               |
  487.      |  C:\VMIX> PATH = C:\;C:\VMIX; (all your apps .EXE paths here) |
  488.      |                                                               |
  489.      |  C:\VMIX> VM_BOOT egacur/set vi -s                            |
  490.      |                                                               |
  491.      |                                                               |
  492.      |  Configuration explanation:                                   |
  493.      |                                                               |
  494.      |  Before you start VMiX, set your DOS path for all the antici- |
  495.      |  pated executables you wish to multitask.                     |
  496.      |                                                               |
  497.      |  'egacur'      Optional, makes sure the cursor displays OK.   |
  498.      |  'set vi -s'   Display a status line, so you can determine the|
  499.      |                name of the foreground task (where the kbd is).|
  500.      |                                                               |
  501.      |   After VMiX starts you would use the 'set remote -l????' and |
  502.      |   'set terminal -t???? to configure logins via the COMM ports,|
  503.      |   if any.  These commands could also be added to the startup  |
  504.      |   line above (See below) or you can edit them into your copy  |
  505.      |   of the VMiX.INI file. The defaults are COM1 (9600 Baud) for |
  506.      |   the remote link and ANSI/VT-100 terminal emulation.         |
  507.      |                                                               |
  508.      |   To start multitasking applications, you will normally use   |
  509.      |   the 'do [-W]' command or you can press Shift-Enter after a  |
  510.      |   command, to start it multitasking.                          |
  511.      |_______________________________________________________________|
  512.  
  513.       _______________________________________________________________ 
  514.      |                                                               |
  515.      | USING YOUR COMM PORTS for remote user logins                  |
  516.      | ---------------------                                         |
  517.      |   -----   if your printer, mouse, or modem is on COM1,        |
  518.      |           then COM2 is available for user logins:             |
  519.      |           (NOTE the lower case 'L', below)                    |
  520.      |                                                               |
  521.      |           C> VM_BOOT set remote -l2 / (etc.)                  |
  522.      |                                                               |
  523.      |   -----   if your printer, mouse, or modem is on COM2,        |
  524.      |           then COM1 (VMiX default) is available for logins:   |
  525.      |                                                               |
  526.      |           NO COMMAND NEEDED                                   |
  527.      |                                                               |
  528.      |   -----   if you are using both COM1 and COM2,                |
  529.      |           then set VMiX to COM3 to avoid interferance:        |
  530.      |           (NOTE the lower case 'L', below)                    |
  531.      |                                                               |
  532.      |           C> VM_BOOT set remote -l3 / (etc.)                  |
  533.      |                                                               |
  534.      |           or, to globaly disable all login polling use:       |
  535.      |                                                               |
  536.      |           C> VM_BOOT set remote -x / (etc.)                   |
  537.      |                                                               |
  538.      |   -----   if you are connecting at a baud rate other than     |
  539.      |           9600 baud (VMiX default), set the baud with:        |
  540.      |                                                               |
  541.      |           C> VM_BOOT set remote -l2/set baud -c2 2400/ (etc.) |
  542.      |_______________________________________________________________|
  543.  
  544.       _______________________________________________________________
  545.      | Cont'd                                                        |
  546.      | ------                                                        |
  547.      |                                                               |
  548.      |           VMiX supports interrupt driven serial I/O up to     |
  549.      |           115,200 Baud.  For information on these and the     |
  550.      |           'set baud -c' command see TECHREF.DOC               |
  551.      |                                                               |
  552.      |   -----   if you want to enable passwords and have entered    |
  553.      |           them into your VMiX.INI file, as well as specified  |
  554.      |           'rshell' or the name of your program(s) to run:     |
  555.      |                                                               |
  556.      |           C> VM_BOOT set remote -l2 vsetup /                  |
  557.      |                      set baud -c2 2400 / (etc.)               |
  558.      |_______________________________________________________________|
  559.  
  560.       _______________________________________________________________
  561.      |                                                               |
  562.      | MULTIUSER CABLING                                             |
  563.      |                                                               |
  564.      | The RS232 cabling for COM1 and/or other user terminal/modem   |
  565.      | serial ports where you intend to have VMiX loggins should be  |
  566.      | constructed depending on whether the host PC will be connected|
  567.      | to a dumb terminal or to another PC acting as a terminal.     |
  568.      |                                                               |
  569.      | A NULL MODEM serial cable can also be used.                   |
  570.      |                                                               |
  571.      |                                                               |
  572.      |         PIN                         PIN                       |
  573.      |                                                               |
  574.      |  H      1                           1                         |
  575.      |  O                                                            |
  576.      |  S      2 -- - _           _ _ - -- 2                         |
  577.      |  T               -_ __ - -                                    |
  578.      |         3 __ _ -         - - - _ __ 3    T                    |
  579.      |  S                                       E                    |
  580.      |  e      4                           4    R                    |
  581.      |  r                                       M                    |
  582.      |  i    --5                           5    I                    |
  583.      |  a  -|                                   N                    |
  584.      |  l |  --6                           6    A                    |
  585.      |    |                                     L                    |
  586.      |  P |    7 ------------------------- 7                         |
  587.      |  o |                                     Add the jumpers to   |
  588.      |  r |  --8                           8    terminal side also,  |
  589.      |  t  -|                                   if using a 2nd PC as |
  590.      |       --20                          20   a terminal.          |
  591.      |                                                               |
  592.      |                                                               |
  593.      |                                                               |
  594.      |                                                               |
  595.      |       See  Part II,   Using VMiX 386,  for                    |
  596.      |       detailed  instructions regarding the                    |
  597.      |       use of VMiX 386 commands and options.                   |
  598.      |_______________________________________________________________|
  599.  
  600.       _______________________________________________________________
  601.      |                                                               |
  602.      | QUICK START TO VMiX MULTITASKING                              |
  603.      |                                                               |
  604.      |     The TECHREF.DOC manual is big and spread out, but it      |
  605.      |     describes each VMiX command in more detail.               |
  606.      |                                                               |
  607.      |     Basically, these are the commands that you must master    |
  608.      |     FIRST, to start using the multitasking features right-    |
  609.      |     away.                                                     |
  610.      |                                                               |
  611.      |                                                               |
  612.      |     ?             Pressing '?' will display a list of avail-  |
  613.      |                   able VMiX commands.  Typing a VMiX command  |
  614.      |                   that requires additional parameters, will   |
  615.      |                   display usage information. Any command can  |
  616.      |                   be abbreviated to 2 or more characters.     |
  617.      |                                                               |
  618.      |                                                               |
  619.      |     exec          This command allows you to partition the    |
  620.      |                   use of your PC's memory between tasks.      |
  621.      |                   By default, on 8088 and 80286 computers,    |
  622.      |                   VMiX partitions each new DOS task into      |
  623.      |                   224Kb chunks of available memory.  On the   |
  624.      |                   80386 the default partition size is 576Kb.  |
  625.      |                                                               |
  626.      |                   To override the defaults, you might type:   |
  627.      |                               exec -m128                      |
  628.      |                                                               |
  629.      |                   this sets the partition size to 128Kb.      |
  630.      |                   Any new program, after that, will only see  |
  631.      |                   a maximum of 128Kb available, until the next|
  632.      |                   'exec -m' reduces or expands the current    |
  633.      |                   limit.                                      |
  634.      |                                                               |
  635.      |                   In 80386 processors, selecting a partition  |
  636.      |                   size smaller than the 576Kb default, will   |
  637.      |                   cause new tasks to use the parent's memory  |
  638.      |                   partition and will not be mapped to their   |
  639.      |                   own 640Kb, from the extended memory pool.   |
  640.      |                                                               |
  641.      |                                                               |
  642.      |     do            This command allows you to specify a new    |
  643.      |                   DOS task. 'do' is short for 'dosjob'.       |
  644.      |                   To execute BASIC in a window, you would     |
  645.      |                   type:                                       |
  646.      |                               do c:\basic                     |
  647.      |                                                               |
  648.      |                   The 'dosjob' command can be omited, if you  |
  649.      |                   press Shift-Enter, instead of just 'Enter'  |
  650.      |                   after the command.                          |
  651.      |                               c:\basic  (press Shift-Enter)   |
  652.      |                                                               |
  653.      |                   'do' is the basic VMiX command to start a   |
  654.      |                   new and separate process.  A forward slash  |
  655.      |                   '/' must preceed any VMiX shell command     |
  656.      |                   given after the 'do'.  The '/' must NOT be  |
  657.      |                   used, if the command is for DOS.            |
  658.      |_______________________________________________________________|
  659.  
  660.       _______________________________________________________________
  661.      | Cont'd                                                        |
  662.      | ------                                                        |
  663.      |                                                               |
  664.      |     do -W         To execute BASIC and give it the full       |
  665.      |                   screen, you would type:                     |
  666.      |                               do -W c:\basic                  |
  667.      |                                                               |
  668.      |                   The keyboard shortcut is to press Shift-    |
  669.      |                   Enter (with both Shift keys pressed, for    |
  670.      |                   full screen) instead of just 'Enter'.       |
  671.      |                                                               |
  672.      |                      c:\basic  (press Shift-Shift-Enter)      |
  673.      |                                                               |
  674.      |                   On the 386/486 the -W switch virtualizes    |
  675.      |                   the video segment of the task, allowing it  |
  676.      |                   to be moved to and from the foreground      |
  677.      |                   without disturbing the display of other     |
  678.      |                   tasks.                                      |
  679.      |                                                               |
  680.      |                   On 8088 or 286 systems you must specify a   |
  681.      |                   new video page or video mode to obtain      |
  682.      |                   a virtualized and separate console for the  |
  683.      |                   task:                                       |
  684.      |                         do -W / set video -p / filespec       |
  685.      |                   or,                                         |
  686.      |                         do -W / set video -m / filespec       |
  687.      |                                                               |
  688.      |                                                               |
  689.      |     Shift-Enter   This is equivalent to the 'do' command.     |
  690.      |                   You press Shift-Enter at the end of a       |
  691.      |                   command to multitask it in a new window.    |
  692.      |                                                               |
  693.      |     Shift-Shift-Enter   This is equivalent to the 'do -W'     |
  694.      |                   command.  You press Enter with both Shift   |
  695.      |                   keys held down at the end of a command to   |
  696.      |                   multitask it with a new full screen.        |
  697.      |                                                               |
  698.      |     Shift-TAB     Once you have started several windows, or   |
  699.      |                   full screen tasks, you will need to move    |
  700.      |                   the keyboard and/or video display between   |
  701.      |                   them, so that input to each task can be     |
  702.      |                   safely directed to only that task.  You     |
  703.      |                   move the keyboard and foreground display,   |
  704.      |                   in round-robin fasion by pressing the       |
  705.      |                   <SHIFT> and <TAB> keys simultaneously.      |
  706.      |                   Shift-Tab will also clear any defunct       |
  707.      |                   window partitions, when there is only one   |
  708.      |                   shell active.                               |
  709.      |                                                               |
  710.      |                   Some tasks disable the cursor blinking, so  |
  711.      |                   its difficult to determine which task is    |
  712.      |                   actively receiving input.  In those cases,  |
  713.      |                   you should enable cursor emulation with:    |
  714.      |                               set system -c                   |
  715.      |                                                               |
  716.      |                   and/or enable the console status line with: |
  717.      |                               set video -s                    |
  718.      |                                                               |
  719.      |_______________________________________________________________|
  720.  
  721.       _______________________________________________________________
  722.      | Cont'd                                                        |
  723.      | ------                                                        |
  724.      |                                                               |
  725.      |     do /rshell    To clone the VMiX command shell into a 2nd  |
  726.      |                   shell, you type:                            |
  727.      |                         do /rshell   or   do -W /rshell       |
  728.      |                                                               |
  729.      |                   The / tells VMiX this is not a command for  |
  730.      |                   DOS but for VMiX.  VMiX will ask you for    |
  731.      |                   a login name.  This is the name that the    |
  732.      |                   VMiX status line will display when this task|
  733.      |                   is at the foreground for kbd input, type:   |
  734.      |                               su                              |
  735.      |                                                               |
  736.      |                   This is a reserved name for a VMiX operator |
  737.      |                   with 'kill' and 'swap' process priviledges. |
  738.      |                                                               |
  739.      |     do .          To clone a DOS command shell as the 2nd     |
  740.      |                   window, you would type:                     |
  741.      |                               do .                            |
  742.      |                   or,                                         |
  743.      |                                .  (and press Shift-Enter)     |
  744.      |                                                               |
  745.      |                   To close the window, type from DOS:         |
  746.      |                               exit                            |
  747.      |                                                               |
  748.      |                   NOTE THAT THE VMiX SHELL PROMPT DIFFERS     |
  749.      |                   FROM THE DOS SHELL PROMPT IN THE SINGLE     |
  750.      |                   SPACE THAT FOLLOWS THE PROMPT.              |
  751.      |                                                               |
  752.      |                   From the VMiX Shell                         |
  753.      |                   a directory request would look like:        |
  754.      |                               C> dir                          |
  755.      |                   From DOS it would look like:                |
  756.      |                               C>dir                           |
  757.      |                                                               |
  758.      |     $$            In non-386 mode, you might find that some   |
  759.      |                   programs might crash or fail to execute     |
  760.      |                   correctly.  To provide system protection,   |
  761.      |                   where changes effected by one task to the   |
  762.      |                   system interrupt table might interfere with |
  763.      |                   the interrupts handlers expected by a second|
  764.      |                   task, precede the filename and path with the|
  765.      |                   characters '$$':                            |
  766.      |                               $$[drive:][path]filename        |
  767.      |                   or,                                         |
  768.      |                               do $$[drive:][path]filename     |
  769.      |                                                               |
  770.      |                                                               |
  771.      |     set           The 'set' command gives you access to all   |
  772.      |                   the VMiX configuration options.             |
  773.      |                   To display a list of all the commands and   |
  774.      |                   arguments associated with the 'set' command |
  775.      |                   enter 'set' from the keyboard.              |
  776.      |                                                               |
  777.      |                                                               |
  778.      |_______________________________________________________________|
  779.  
  780.       _______________________________________________________________
  781.      | Cont'd                                                        |
  782.      | ------                                                        |
  783.      |                                                               |
  784.      |     NOW THAT YOU KNOW EVERYTHING, YOU CAN CHOOSE TO FORGET    |
  785.      |     ALL ABOUT IT AND INSTEAD, USE THE VMiX PULL-DOWN MENUS    |
  786.      |     BY TYPING, AFTER VMiX STARTS:                             |
  787.      |                                                               |
  788.      |                   C> c:\vmix\vw                               |
  789.      |                                                               |
  790.      |         See the INSTRUCTIONS section below, for VW user       |
  791.      |         information.                                          |
  792.      |                                                               |
  793.      |         VW requires your PATH to include the directory where  |
  794.      |         the VMiX utilities reside.                            |
  795.      |                                                               |
  796.      |     REMEMBER THAT ANY COMMAND YOU CAN GIVE FROM INSIDE VMiX   |
  797.      |     CAN ALSO BE STATED IN THE VM_BOOT COMMAND LINE OR INCLUDED|
  798.      |     IN THE [startup] SECTION OF YOUR VMiX.INI FILE.           |
  799.      |                                                               |
  800.      |     Congratulations, you are now a certified VMiX SysOp.      |
  801.      |_______________________________________________________________|
  802.  
  803.       _______________________________________________________________
  804.      |                                                               |
  805.      | IMPORTANT NOTICE                                              |
  806.      |                                                               |
  807.      | VMiX STARTUP PROBLEMS:                                        |
  808.      |                                                               |
  809.      |         We have found that the following reasons are the most |
  810.      |         frequent causes of VMiX 386 failure.                  |
  811.      |                                                               |
  812.      |      a) Cable connected to COM1 port which causes VMiX port   |
  813.      |         test to hang during startup.  Recommend to test       |
  814.      |         VMiX with serial cable disconnected during VM_BOOT    |
  815.      |         process.  Make a new cable as described below.        |
  816.      |                                                               |
  817.      |      b) The contents of your CONFIG.SYS specify a device      |
  818.      |         driver that uses extended memory in conflict          |
  819.      |         with VMiX in 386 mode. (for example, SMARTDRV.SYS,    |
  820.      |         QEMM.SYS, EMM386.SYS)                                 |
  821.      |                                                               |
  822.      |      c) Failure to reassign VMiX's default port for user      |
  823.      |         logins, COM1, to another port number when it is       |
  824.      |         already in use (modem, mouse, etc.).  Recommend to    |
  825.      |         start VMiX with a non-existent port for logins:       |
  826.      |         (NOTE the lower case 'L', below)                      | 
  827.      |                                                               |
  828.      |              VM_BOOT set remote -l4       (ie., COM4)         | 
  829.      |                                                               |
  830.      |      d) In 386 mode, VMiX incorrectly maps your ROM and       |
  831.      |         high DOS memory usage.  VMiX loads portions of        |
  832.      |         itself to the first available area between C000       |
  833.      |         and F000.  It is possible for VMiX to erroneously     |
  834.      |         identify an area in use, as being free.  In that      |
  835.      |         case, VMiX will fail to boot.  Force VMiX to use a    |
  836.      |         known free area with the startup command:             |
  837.      |                                                               |
  838.      |              VM_BOOT ems=D000   (ie., if D000 is free)        |
  839.      |         or,                                                   |
  840.      |              VM_BOOT ems=FFFF   (ie., do not use EMS)         |
  841.      |                                                               |
  842.      |      e) Using 'swap' with a previously loaded external        |
  843.      |         program or TSR that uses extended memory, when VMiX   |
  844.      |         is in 286 mode and it has not been told to reserve    |
  845.      |         in-use extended memory at boot time:                  |
  846.      |                                                               |
  847.      |                     VM_BOOT exclude=500                       |
  848.      |                                                               |
  849.      |         If 500Kb are already in use.                          |
  850.      |                                                               |
  851.      |      f) Using an ANSI.SYS driver that does not support        |
  852.      |         discreet window scrolling, but instead, always        |
  853.      |         scrolls the entire screen.  Quarterdeck Office        |
  854.      |         System supplied DVANSI.COM (for DESQview) works       |
  855.      |         correctly with VMiX 386.                              |
  856.      |                                                               |
  857.      |      g) Using VMiX with DOS 4.01 on some 386 computers        |
  858.      |         will boot OK, but multitasking will be erratic        |
  859.      |         or lock the system.  Try the retail version of        |
  860.      |         DOS 4.01 or switch to Version 5.0, if possible.       |
  861.      |_______________________________________________________________|
  862.  
  863.       _______________________________________________________________
  864.      |                                                               |
  865.      |      h) The following vendor's 386 computers are known        |
  866.      |         to crash (incompatible) or not crash (compatible)     |
  867.      |         VMiX during 386 protected mode startup:               |
  868.      |                                                               |
  869.      |      (Some 386 BIOSes like Compaq's, Toshiba 5100 and         |
  870.      |       Northgate 386 are currently having a problem with       |
  871.      |       VMiX + DOS 4.01)  The DOS 4.01 we have tested is the    |
  872.      |       retail, Microsoft original, MS-DOS 4.01.                | 
  873.      |                                                               |
  874.      |             Incompatible              Compatible              |
  875.      |           ----------------          -------------------       |
  876.      |           CompuAdd 386              AST Premium 386           |
  877.      |           HP Vectra 386             AT&T 386                  |
  878.      |           IBM PS/2 30               Cheetah cAT 386-20        |
  879.      |           Zenith 386                COMPAQ 386-25             |
  880.      |                                     COMPAQ 386-SX             |
  881.      |                                     COMPAQ 486-33             |
  882.      |                                     COMPAQ Deskpro            |
  883.      |                                     Dell 310                  |
  884.      |                                     Everex 386-16             |
  885.      |                                     Everex Step 386-25        |
  886.      |                                     Gateway 2000 386-20       |
  887.      |                                     IBM PS/2 70-80            |
  888.      |                                     Micronics 386             |
  889.      |                                     Monolithic 386-16         |
  890.      |                                     Northgate 386             |
  891.      |                                     Olivetti 386-20           |
  892.      |                                     Tandy 5000                |
  893.      |                                     ZEOS 386                  |
  894.      |_______________________________________________________________|
  895.  
  896.       _______________________________________________________________
  897.      |                                                               |
  898.      | SHIPPING LIST                                                 |
  899.      |                                                               |
  900.      | The VMiX 386 System consists of the 37 files described below. |
  901.      |                                                               |
  902.      | These files reside in the four self-extracting archives:      |
  903.      |                                                               |
  904.      |     VMIX???.EXE (Shareware distribution VERSION ???)          |
  905.      |     VMIX386.EXE (Shareware, only for 386/486 computers)       |
  906.      |                  Available from our BBS                       |
  907.      |     VMIX386.EXE (Registered Owners ONLY)                      |
  908.      |     VMIXUTL.EXE (Registered Owners ONLY)                      |
  909.      |     FOR8086.EXE (Registered Owners ONLY)                      |
  910.      |                                                               |
  911.      |                                                               |
  912.      |                   EXECUTABLE or OBJECT FILES                  |
  913.      |                                                               |
  914.      |     - VM_BOOT.EXE -                                           |
  915.      |     The VMiX startup program.                                 |
  916.      |     To start, type VM_BOOT from DOS's C> prompt and press     |
  917.      |     <ENTER>.                                                  |
  918.      |                                                               |
  919.      |     - DPATH.EXE -                                             |
  920.      |     Utility executed by user to set the directory search PATH |
  921.      |     for data files (not usually needed, since VMiX now vir-   |
  922.      |     tualizes the default directory of each task).             |
  923.      |                                                               |
  924.      |     Use DOS's  'PATH ='  or 'SET PATH ='  for executables.    |
  925.      |     Use VMiX's 'DPATH =' or 'SET DPATH =' for data files.     |
  926.      |                                                               |
  927.      |     - DSTAT.EXE -                                             |
  928.      |     Utility executed by user to view device and channel       |
  929.      |     status.                                                   |
  930.      |                                                               |
  931.      |     - LOADUP.EXE -                                            |
  932.      |     Utility to load TSRs, from inside VMiX, to upper memory   |
  933.      |     above 640Kb.                                              |
  934.      |                                                               | 
  935.      |     - MONITOR.EXE -                                           |
  936.      |     Debugging utility used to monitor process information,    |
  937.      |     system memory and open files status.                      |
  938.      |                                                               |
  939.      |     - OUTSIDE.EXE -                                           |
  940.      |     DOS shell spawning utility for sysops running BBS         |
  941.      |     software under VMiX.  This utility can be used by a bbs   |
  942.      |     caller to exit via the modem to a VMiX shell.             |
  943.      |     The syntax is:                                            |
  944.      |               outside.exe [-c ????]                           |
  945.      |               where ???? is the COMM port (default is COM1)   |
  946.      |                                                               |
  947.      |     - PS.EXE -                                                |
  948.      |     Utility executed by user to view process status.          |
  949.      |                                                               |
  950.      |     - VSETUP.EXE -                                            |
  951.      |     Utility executed at startup to process the VMiX           |
  952.      |     configuration file, VMiX.INI                              |
  953.      |_______________________________________________________________|
  954.  
  955.       _______________________________________________________________
  956.      | Cont'd                                                        |
  957.      | ------                                                        |
  958.      |                                                               |
  959.      |     - VT.EXE -                                                |
  960.      |     Utility executed by user to start a remote session at a   |
  961.      |     second, serialy connected, VMiX host.                     |
  962.      |                                                               |
  963.      |     - VW.EXE -                                                |
  964.      |     Utility executed by user to add a pull-down menus         |
  965.      |     interface to the VMiX shell.                              |
  966.      |                                                               |
  967.      |     - VMiX.INI -                                              |
  968.      |     Sample VMiX configuration file (editable text file)       |
  969.      |                                                               |
  970.      |     - SYSGATE.OBJ -                                           |
  971.      |     Link object file for accessing the VMiX API (Application  |
  972.      |     Programming Interface).                                   |
  973.      |_______________________________________________________________|
  974.  
  975.       _______________________________________________________________
  976.      |                                                               |
  977.      |     SOURCE FILES              DOCUMENTATION FILES             |
  978.      |                                                               |
  979.      |     DPATH.ASM                 DPATH.DOC                       |
  980.      |     LOADASM.ASM               READ.ME                         |
  981.      |     SYSGATE.ASM               VMiX.DOC     (this file)        |
  982.      |     VT.ASM                    REVISION.LOG (upgrade history)  |
  983.      |     DSTAT.C                   TECHREF.DOC                     |
  984.      |     LOADUP.A                                                  |
  985.      |     LOADUP.C                                                  |
  986.      |     MONITOR.C                                                 |
  987.      |     OUTSIDE.C                                                 |
  988.      |     PS.C                                                      |
  989.      |     VSETUP.C                                                  |
  990.      |     VW.C                                                      |
  991.      |     C_BIOS.H                                                  |
  992.      |     LOADUP.H                                                  |
  993.      |     $_CONFIG.H                                                |
  994.      |     $_KERNEL.H                                                |
  995.      |     $_MEM.H                                                   |
  996.      |     $_PROC.H                                                  |
  997.      |     IO_CHAN.H                                                 |
  998.      |     IO_IRP.H                                                  |
  999.      |     IO_OBJ.H                                                  |
  1000.      |_______________________________________________________________|
  1001.  
  1002.  
  1003.  
  1004.       VMiX COMMAND LOOK-UP - QUICK REFERENCE
  1005.  
  1006.  
  1007. |ROOT   |DEBUG....................................|
  1008.  
  1009. |LEVEL..|LEVEL..|LEVEL............................|
  1010. |   0   |   1   |   2                             |
  1011. |_______._______._________________________________|
  1012. |       .       .                                 |
  1013. |[debug].       .                                 |
  1014. |       |set    .                                 |
  1015. |       .       |baud                             |
  1016. |       .       .  -c  " sets COMM port: chan,    |
  1017. |       .       .        baud, parity, word, stop"|
  1018. |       .       |dos                              |
  1019. |       .       .  -f  " toggles DOS process file |
  1020. |       .       .        inherit ON/OFF"          |
  1021. |       .       .  -n  " sets DOS INT21 function  |
  1022. |       .       .        maximum nesting level"   |
  1023. |       .       .  -p  " sets DOS current process |
  1024. |       .       .        PSP: nuPSP(seg)"         |
  1025. |       .       .  -s  " sets DOS virtual size:   |
  1026. |       .       .        (4Kb blocks)"            |
  1027. |       .       |font                             |
  1028. |       .       .  -t  " sets font type (0 - 3)"  |
  1029. |       .       |pool                             |
  1030. |       .       .  -a  " adjusts program memory:  |
  1031. |       .       .        MCB(seg), nusize(para)"  |
  1032. |       .       .  -m  " sets program partition   |
  1033. |       .       .        size (0 - 1024Kb)"       |
  1034. |       .       .  -o  " sets program memory      |
  1035. |       .       .        owner: MCB(seg),         |
  1036. |       .       .        nuPSP(seg)"              |
  1037. |       .       |process                          |
  1038. |       .       .  -b  " sets shell buffer size   |
  1039. |       .       .        (0 - 127)"               |
  1040. |       .       .  -e  " toggles environment      |
  1041. |       .       .        protection ON/OFF"       |
  1042. |       .       .  -h  " toggles hardware         |
  1043. |       .       .        priviledge ON/OFF"       |
  1044. |       .       .  -s  " toggles system           |
  1045. |       .       .        priviledge ON/OFF"       |
  1046. |       .       .  -w  " sets preemption I/O wait |
  1047. |       .       .        cycles"                  |
  1048. |       .       |remote                           |
  1049. |       .       .  -a  " toggles polling of all   |
  1050. |       .       .        channels ON/OFF"         |
  1051. |       .       .  -c  " sets remote console      |
  1052. |       .       .        channel"                 |
  1053. |       .       .  -i  " toggles fast RS232       |
  1054. |       .       .        ON/OFF"                  |
  1055. |       .       .  -l  " sets terminal login      |
  1056. |       .       .        channel"                 |
  1057. |       .       .  -x  " toggles terminal logins  |
  1058. |       .       .        ON/OFF"                  |
  1059. |       .       |system                           |
  1060. |       .       .  -c  " toggles cursor emulation |
  1061. |       .       .        ON/OFF                   |
  1062. |       .       .  -d  " sets duration of task    |
  1063. |       .       .        slice: tickcnt - 1"      |
  1064. |       .       .  -m  " toggles operator         |
  1065. |       .       .        messages ON/OFF"         |
  1066. |       .       .  -s  " toggles swapper ON/OFF   |
  1067. |       .       .  -t  " toggles scheduler ON/OFF |
  1068. |       .       .  -v  " toggles maximum DOS size |
  1069. |       .       .        ON/OFF"                  |
  1070. |       .       .  -w  " sets shutdown wait delay:|
  1071. |       .       .        seconds"                 |
  1072. |       .       |terminal                         |
  1073. |       .       .  -t  " sets terminal type (0-9) |
  1074. |       .       |video                            |
  1075. |       .       .  -c  " sets video bg/fg colors" |
  1076. |       .       .  -C  " sets window bg/fg colors"|
  1077. |       .       .  -m  " sets video mode (0 - 18)"|
  1078. |       .       .  -p  " sets vide0 page (0 - 3)" |
  1079. |       .       .  -s  " toggles status display   |
  1080. |       .       .        ON/OFF"                  |
  1081. |       .       .  -w  " sets window size:        |
  1082. |       .       .        row0, col0, row1, col1"  |
  1083. |       .       .  -W  " auto partitions task     |
  1084. |       .       .        windows (Shift-Tab moves |
  1085. |       .       .        kbd between windows)"    |
  1086. |       |init                                     |
  1087. |       .       |comm                             |
  1088. |       .       .  -c  " sets COMM port: chan,    |
  1089. |       .       .        baud, parity, word, stop"|
  1090. |       .       |print                            |
  1091. |       .       .  -p  " inits parallel port:chan"|
  1092. |       |examine                                  |
  1093. |       .       |mcb                              |
  1094. |       .       |memory                           |
  1095. |       .       .      " : seg[:offset] [= byte]" |
  1096. |       .       |status                           |
  1097. |       |assign                                   |
  1098. |       .      " :[process id], obj type, channel"|
  1099. |       .       |gdt                              |
  1100. |       |deassign                                 |
  1101. |       .      " : channel"                       |
  1102. |       .       |gdt                              |
  1103. |       .       |memory                           |
  1104. |       |quit                                     |
  1105. |rshell                                           |
  1106. |remote                                           |
  1107. |  -a  " toggles global polling ON/OFF"           |
  1108. |  -c  " sets remote console channel: channel id" |
  1109. |  -i  " toggles fast RS232 ON/OFF"               |
  1110. |  -l  " sets terminal login channel: channel id" |
  1111. |  -x  " toggles terminal logins ON/OFF"          |
  1112. |swap                                             |
  1113. |      " : process id"                            |
  1114. |chprio                                           |
  1115. |      " : process id, new priority"              |
  1116. |[exec]                                           |
  1117. |  -a  " adjusts program memory: MCB(seg),        |
  1118. |        nusize(para)"                            |
  1119. |  -m  " sets program partition size (0 - 1024Kb)"|
  1120. |  -o  " sets program memory owner: MCB(seg),     |
  1121. |        nuPSP(seg)"                              |
  1122. |       |path          " utility displays/sets    |
  1123. |       .                program file search path"|
  1124. |       |dpath[.exe]   " utility displays/sets    |
  1125. |       .                data file search path"   |
  1126. |       .  -v  " sets verbose mode (default)"     |
  1127. |       .  -q  " sets quiet mode"                 |
  1128. |       .  -r  " allows data read only"           |
  1129. |       .  -w  " allows data read/write (default)"|
  1130. |       .  -h  " help"                            |
  1131. |       |dstat[.exe]   " utility displays all     |
  1132. |       .                VMiX objects/channels"   |
  1133. |       .  -a  " selects only assigned objects"   |
  1134. |       .  -r  " selects only free objects"       |
  1135. |       |loadup.[exe]  " VMiX loadhi utility to   |
  1136. |       .                place TSRs above 640Kb"  |
  1137. |       . [/seg=]  " forces load to specified     |
  1138. |       .            segment"                     |
  1139. |       . [/size=] " specifies size for upper     |
  1140. |       .            memory block in Kbytes"      |
  1141. |       . [/help]  " displays help"               |
  1142. |       .          " : filespec"                  |
  1143. |       |monitor[.exe] " utility monitors process |
  1144. |       .                or system: process id"   |
  1145. |       .  -f  " monitors all open files"         |
  1146. |       .  -m  " displays 1 megabyte memory map"  |
  1147. |       .  -p  " displays VMiX memory pool info"  |
  1148. |       .  -r  " monitors process registers and   |
  1149. |       .        system memory: process id"       |
  1150. |       |ps[.exe]      " utility displays all     |
  1151. |       .                processes status"        |
  1152. |       |vsetup[.exe]  " utility to process       |
  1153. |       .                VMiX.INI file"           |
  1154. |       |vt[.exe]      " utility to login to a    |
  1155. |       .                remote VMiX host"        |
  1156. |       |vw[.exe]      " VMiX pull-down menus     |
  1157. |       .                utility"                 |
  1158. |       .  -i  " interactive keyboard mode"       |
  1159. |      " : MS-DOS command"                        |
  1160. |dosjob                                           |
  1161. |      " : MS-DOS command or / VMiX command"      |
  1162. | [-W] " gives process the full screen: MS-DOS    |
  1163. |        command or / VMiX command"               |
  1164. |spawn                                            |
  1165. |  -c  " sets channel for STDIO and executes      |
  1166. |        command line: channel id / command line" |
  1167. |kill                                             |
  1168. |      " : process id"                            |
  1169. |quit                                             |
  1170. |_________________________________________________|
  1171.  
  1172.    :   indicates command parameters
  1173.   [ ]  indicates optional
  1174.  
  1175.  
  1176.     VMiX TERMINAL - IBM FUNCTION KEY EMULATION
  1177.  
  1178.  _________________________________________________
  1179. |                                                 |
  1180. | Press ^F (1 beep) PC Keyboard emulation ON      |
  1181. | Press ^F again (2 beeps) emulation OFF          |
  1182. |                                                 |
  1183. |                                                 |
  1184. |        for                      press           |
  1185. |                                                 |
  1186. |        IBM PC KEY               TERMINAL KEY    |
  1187. |                                                 |
  1188. |         [F1]                         1          |
  1189. |         [F2]                         2          |
  1190. |         [F3]                         3          |
  1191. |         [F4]                         4          |
  1192. |         [F5]                         5          |
  1193. |         [F6]                         6          |
  1194. |         [F7]                         7          |
  1195. |         [F8]                         8          |
  1196. |         [F9]                         9          |
  1197. |         [F10]                        10         |
  1198. |                                                 |
  1199. |         <Ctrl>[Break]                ^C         |
  1200. |         <Ctrl>[NumLock]              ^S         |
  1201. |         <Ctrl>[F3]                    ~         |
  1202. |         [PgUp]                        +         |
  1203. |         [PgDn]                        -         |
  1204. |         [Ins]                        ^I         |
  1205. |         [Del]                        ^D         |
  1206. |         [End]                        ^E         |
  1207. |         [UP]                         ^J see note|
  1208. |         [DOWN]                       ^K see note|
  1209. |         [LEFT]                       ^H see note|
  1210. |         [RIGHT]                      ^L see note|
  1211. |         [Home]                      [Home]      |
  1212. |         <Alt>                       <Shift>     |
  1213. |                                                 |
  1214. |                                                 |
  1215. |                                                 |
  1216. | NOTE:  The <Ctrl> key symbol for the terminal   |
  1217. | keyboard has been abbreviated as ^              |
  1218. |                                                 |
  1219. | ^F (1 beep) enables the Keypad ARROWS to work   |
  1220. | directly, when in VT-100 terminal emulation.    |
  1221. |_________________________________________________|
  1222.  
  1223.  
  1224.                                RELEASE NOTES
  1225.  
  1226. * See the REVISION.LOG file for enhancements and bug fixes to this version.
  1227.   In Summary Version 2.67 is a NEW release and provides:
  1228.  
  1229.   NOTE for Brief Editor users: if running Brief from a remote terminal
  1230.        session, start brief with the -p flag to force use of the first
  1231.        video page only.
  1232.  
  1233.  
  1234.   1. Added a very flexible configuration file, VMiX.INI, to assist in
  1235.      configuring VMiX startup, entering passwords, and specifying user
  1236.      programs to autostart after a remote COMM port login.
  1237.  
  1238.      The configuration file (optional) works in cunjunction with the new
  1239.      VSETUP.EXE utility.  This utility is normally invoked in the two ways,
  1240.      described below.
  1241.  
  1242.      The sample VMiX.INI included, is intended as a template for you to
  1243.      make your own configuration file.  VMiX.INI is a text file and can
  1244.      be edited with any editor.
  1245.  
  1246.      VSETUP currently performs 3 functions:
  1247.  
  1248.           1) If it finds the [access passwords] Section in VMiX.INI,
  1249.              it backups the file to VMiX.BAK and encrypts the text
  1250.              passwords, changing the Section name to [encrpt passwords].
  1251.  
  1252.           2) If invoked during startup, it will execute multiple command
  1253.              lines given in the [startup] Section.  This is an alternative
  1254.              to typing all startup commands in the VM_BOOT command line.
  1255.              (System Options, however, can ONLY be given at the command line)
  1256.  
  1257.           3) If invoked during a COMM port access, (you must have issued
  1258.              a 'set remote -l???? vsetup' command) it will prompt for
  1259.              an access password and match it against the encrypted
  1260.              password list in VMiX.INI.  After verifying access, it will
  1261.              dispatch the single command line under the [remote startup]
  1262.              Section, in VMiX.INI (the single command line can have
  1263.              multiple commands, separated by a '/').
  1264.  
  1265.      NOTE that the nine System Startup Options (See 13., below) can ONLY
  1266.           be given at the VM_BOOT command line, since VSETUP runs after
  1267.           VM_BOOT has already started.
  1268.  
  1269.      The new utility VSETUP.EXE will process the .INI file when invoked
  1270.      in the VM_BOOT startup command line.  When used in the VM_BOOT
  1271.      startup sequence, VSETUP will only process the lines given under
  1272.      the [startup] Section in VMiX.INI
  1273.  
  1274.      The new utility VSETUP.EXE (or a user program) can also be specified
  1275.      with the 'set remote -l' command.  VSETUP.EXE controls password access
  1276.      and the startup of any program given in the [remote startup] Section in
  1277.      VMiX.INI.  Invoking 'set remote -l' without specifying VSETUP.EXE will
  1278.      reset logins to the standard access method (rshell).
  1279.  
  1280.      To ensure that VSETUP.EXE can always find VMiX.INI, the best way to
  1281.      start VMiX is with a full filespec and path for VM_BOOT.EXE,
  1282.      ie., C:\VMiX\VM_BOOT VSETUP        (from the VMiX directory)
  1283.      then, you can change directories, and reset path and VSETUP will
  1284.      always find VMiX.INI (during remote logins).
  1285.  
  1286.   2. Remote logins will now work at the high (interrupt driven) baud rates
  1287.      above 9600 KBaud.  High baud rates are set for a given channel, just
  1288.      as the standard rates, with the 'set baud -c???? <baud rate>' or with
  1289.      'init comm -c???? <baud rate>'.  Available baud rates are: 300, 1200,
  1290.      2400, 4800, 9600, 19200, 38400, and 115200.  The VMiX utility DSTAT.EXE
  1291.      will display the baud rate settings for all channels assigned to
  1292.      COMM ports.
  1293.  
  1294.   3. Added support for virtualized default directories.  Each task now has
  1295.      its own default directory, independent of what others have.  Previously
  1296.      only default drives were virtualized.
  1297.  
  1298.   4. Added a (L)aunch application option to the VW.EXE utility to allow you
  1299.      to launch an application directly, instead of starting a shell for it
  1300.      first and then invoking the application.  The application (L)aunch
  1301.      option resides in the (P)rograms menu.
  1302.  
  1303.   5. Added support for DOS 5.0 and HIMEM.SYS.  You can load DOS to high
  1304.      memory (along with its BUFFERS) using the dos=high and device=himem.sys
  1305.      commands in CONFIG.SYS.  You can experiment with removing dos=high,
  1306.      and let VMiX use the high memory for itself or let DOS relocate there.
  1307.  
  1308.   6. Added the LOADUP.EXE utility to allow user loading of TSRs to upper
  1309.      memory (386 MODE IS REQUIRED).  TSR is visible only to process that
  1310.      started it, since each VMiX task is virtually mapped to a separate
  1311.      virtual first megabyte.  This means that you can have different
  1312.      (or the same) TSRs active for each partition.
  1313.  
  1314.      LOADUP will NOT load TSR's on 8086 or 286 computers, unless upper
  1315.      memory is already provided by EMS hardware or other software.
  1316.  
  1317.      VMiX is now compatible with XMS drivers, like HIMEM.SYS.
  1318.      However, VMiX will not work with other 80386 virtual memory managers,
  1319.      like QEMM.SYS or 386MAX.SYS and defaults to 8086 mode when detected.
  1320.  
  1321.      Since you can not use another extended memory manager when using
  1322.      VMiX, the LOADUP utility has been provided to move TSRs to upper memory.
  1323.      Since VMiX is not running at CONFIG.SYS time, there is still no way to
  1324.      do the same thing with device drivers, but we are working on it.
  1325.  
  1326.      LOADUP is not yet as smart as other LOADHI programs,
  1327.  
  1328.      The command syntax is:
  1329.  
  1330.                LOADUP [/help] [/segment=] [/size=] filespec
  1331.  
  1332.      We recommend that you do the first TSR load with /size=128 (number of
  1333.      1Kb blocks) and reduce the size if LOADUP reports memory unavailable.
  1334.      For subsequent TSR loads, invoke LOADUP again, this time  with /size=0,
  1335.      since the upper memory block has already being assigned, but not
  1336.      necessarily all used.  New TSRs will look for unused memory within the
  1337.      upper memory block assigned in the first LOADUP.
  1338.  
  1339.      At the first LOADUP invocation, you want to specify a size equal to the
  1340.      largest contiguous space available above your video ROM area (depending
  1341.      on your HDisk controller and other installed adapters, this area size is
  1342.      usually between 64 and 128 kilobytes).  If no size is given, LOADUP
  1343.      looks for 64 Kbytes in upper memory to load the TSR.  The second, third,
  1344.      etc. time a TSR is loaded, you should specify a size of 0 (or, if known,
  1345.      the actual size required by the TSR).  If you know what you are doing,
  1346.      you may also specify the load segment location (i.e., /segment=D000).
  1347.  
  1348.      If your TSRs requires less than 64 Kbytes, then 'LOADUP filespec' will
  1349.      work fine without any arguments.
  1350.  
  1351.   5. Added the VT.EXE remote utility to serially link together two different
  1352.      VMiX hosts (115.2 Kbaud maximum).  This will form the basis for a VMiX
  1353.      distributed system in a network of two or more VMiX systems.  VT will
  1354.      start a remote session with the second computer via the COMM port
  1355.      currently specified by 'set remote -l ????' (you can determine the
  1356.      current setting with the 'examine status' command).  You can then
  1357.      execute from host-1 any program on host-2.  We will be adding mountable
  1358.      remote files systems soon.
  1359.  
  1360.      To set up a single remote session from host-1 connected to host-2
  1361.      use the following:
  1362.  
  1363.             host-1                            host-2
  1364.  
  1365.        set remote -l1                     set remote -l1       (COM1 for both)
  1366.        do vt.exe                              -       (Request host-2 session)
  1367.        login                                  - (host-2 asks for session name)
  1368.                                                                   (you are in)
  1369.  
  1370.      To set up dual links (one VT session on host-1 running on host-2, and
  1371.      another VT session on host-2 running on host-1 use the following:
  1372.  
  1373.             host-1                            host-2
  1374.  
  1375.        set remote -l1                     set remote -l1       (COM1 for both)
  1376.        do vt.exe                              -               (host-2 session)
  1377.        login                                  -                 (session name)
  1378.        press Shift-Tab                        -               (switch to Root)
  1379.        set remote -l2                     set remote -l2       (COM2 for both)
  1380.            -                              do vt.exe           (host-1 session)
  1381.            -                              login                   (enter name)
  1382.        press Shift-Tab                        -                 (return to VT)
  1383.  
  1384.      NOTE:  To activate (and transmit to the remote host) the IBM function
  1385.      key equivalents (like Alt-X, PgUp, up-arrow, F3, etc.) you must toggle
  1386.      IBM emulation by pressing Ctrl-F.  Then the application in the VT
  1387.      window will respond to the special keys (see Table below).
  1388.      You will need to press Ctrl-F again to disable IBM emulation, after
  1389.      the special keys are used so that the keyboard Shift key will act
  1390.      correctly (this is a side effect of assuming that you could be at
  1391.      a terminal with no IBM special keys to press).  
  1392.  
  1393.      NOTE:  If you have started a VT session and type 'set baud -c1 2400',
  1394.      you will be setting the remote computer send baud rate, you will
  1395.      need to press Shift-Tab and switch to a local session to perform
  1396.      the same command for your local computer, so that they both sync at
  1397.      the new baud rate.
  1398.  
  1399.      To quit VT.EXE press Alt-Z.  This will terminate the VT program,
  1400.      but will not quit the remote session.  You should 'quit' the remote
  1401.      session first (by typing 'quit'), before pressing Alt-Z.
  1402.  
  1403.   6. Programs that make direct video writes are now supported at remote
  1404.      COMM port terminals (remote logins).  All video memory accesses will
  1405.      be redirected to the COMM port and will not appear at the console.
  1406.      (Feature available only in 386 computers).
  1407.  
  1408.   7. Added an alternate way to start NEW TASKS MULTITASKING.  Pressing
  1409.      Shift-Enter or Shift-Shift-Enter, will start a new task, just as if
  1410.      you had typed 'dosjob'.  The Shift-Enter is used, instead of just the
  1411.      Enter key, after typing a command.  If both Shift toggles are pressed
  1412.      when the Enter key is hit, the new task will use the full screen.  If
  1413.      only one Shift is held down, the task will start in a new window.
  1414.      If the command is for VMiX, like 'rshell', you must preceed it with a
  1415.      forward '/' (i.e., '/rshell').  DOS commands are always entered the
  1416.      same as in a DOS shell.
  1417.  
  1418.   8. The graphics options of VMiX and the status line are now included in
  1419.      the shareware version.  You need the graphics capability to multitask
  1420.      Windows 3.0 under VMiX.
  1421.  
  1422.      To start Windows 3.0, under VMiX 386, you should use the command
  1423.  
  1424.      do -W /set video -m18/win -r        (you should remove HIMEM.SYS from
  1425.                                           your CONFIG.SYS file to force
  1426.                                           WINDOWS to run in real mode)
  1427.  
  1428.      This will set VGA graphics mode before invoking Windows in Real Mode,
  1429.      thus VMiX will setup extended memory for a virtualized graphics
  1430.      video area, instead of a smaller virtualized text area.  The Shift-Tab
  1431.      hot key will swap to non-Windows tasks in any video mode, but upon
  1432.      return to Windows, the color palette will be changed, since the RAM DAC
  1433.      palette memory is not currently being saved during video mode changes.
  1434.  
  1435.      Added the 'set process -w????' command, where ???? is the number of
  1436.      idle input or output cycles before a process is put to sleep.  If this
  1437.      parameter is set to 0, then all processes will always be timesliced.
  1438.      With programs that grab the keyboard, like Windows, this will allow
  1439.      the VMiX hot key Shift-Tab to be recognized, since there will always be
  1440.      a non-windows process awake to field the hot key.  This command is
  1441.      only used with non-386 computers, since in the 386, the VMiX protected
  1442.      mode supervisor is always running to detect the hot key.
  1443.  
  1444.   9. Added the 'set remote -i' command to allow the user to toggle ON/OFF
  1445.      the VMiX INT 14h interrupt driven serial port driver.  To enable the
  1446.      port for fast, interrupt driven communications you must issue a 'set
  1447.      remote -i' followed by a 'set baud -c ????' command to open the port.
  1448.      When in fast COMM mode,  110 baud becomes 19.2 Kbaud, 150 baud becomes
  1449.      38.4 Kbaud, and 600 baud becomes 115.2 Kbaud.  To set 115.2 Kbaud you
  1450.      would use 'set baud -c1 600'.
  1451.  
  1452.      The 'set remote -a' command allows all COMM port to be polled
  1453.      simultaneously for user login requests.  This command slows down the
  1454.      scheduler.  The default and preferred method is 'set remote -l ????'
  1455.      (to poll a specific COMM port, at a time).  This method offers less
  1456.      overhead.  Also, other COMM port devices might be connected that could
  1457.      trigger fake logins during global polling (ie., modems, mice, or
  1458.      printers).
  1459.  
  1460.      Logins can be globally enabled/disabled with the 'set remote -x' command
  1461.      toggle.  The default is logins enabled.
  1462.  
  1463.      The 'set remote -l' command controls the comm port where user logins
  1464.      are polled for (when 'set remote -a' is in effect and VMiX is polling
  1465.      all ports, this command has no effect).  However, this command is
  1466.      always used to set the port that a VT session will use to connect to
  1467.      a remote VMiX host.
  1468.  
  1469.      The 'set remote -c' commands RELOCATES the operator console that the
  1470.      VM_BOOT program used during startup to the remote channel specified.
  1471.      That means the old console device (where the initial task is always
  1472.      running) is disabled and relocated to the specified channel.  You can
  1473.      use the 'assign process' command to move it back to the original console
  1474.      device (see TECHREF>DOC).  Pressing <Ctrl><F>, followed by <Ctrl><Z>
  1475.      will also return the Root process back to the startup console, but is
  1476.      not as clean as the 'assign' command.
  1477.  
  1478.  10. On 8086 PCs or 286 ATs, if an EMS board is installed and an EMS manager
  1479.      is driver is present, VMiX can use EMS to reduce its low memory size
  1480.      by 32Kb.  The 'EMS=????' command must be given at startup, where ????
  1481.      is the Hex Segment Address of the EMS area (i.e., VM_BOOT EMS=D000),
  1482.      32Kb of contiguous space is required.  On 386 ATs, VMiX automatically
  1483.      uses its own EMS emulator.
  1484.  
  1485.  11. VMiX supports virtualized video in 386 mode.  In 286 computers, you
  1486.      must start tasks on different video pages (see below).  This eliminates
  1487.      bleed-through by applications that write directly to the screen.  Tasks
  1488.      started with the 'dosjob -W' command, and all tasks started at a dumb
  1489.      terminal will execute with virtualized video segments, in 386 mode.
  1490.      The Shift-Tab hot key will bring a virtualized task's video to the
  1491.      foreground.
  1492.  
  1493.      VMiX now handles video mode swapping between graphics and text modes.
  1494.      The Shift-Tab hot-key will switch the console between tasks running
  1495.      in graphics modes and those running in text mode.  The VW pull-down
  1496.      menus program (Process Menu) will allow new shells to be started in the
  1497.      video mode of your choice (and/or video page of choice in Text Mode).
  1498.      The same can be accomplished from the command line with:
  1499.  
  1500.                           'do -W /set video -m/rshell'  (for mode select)
  1501.      or,
  1502.                           'do -W /set video -p/rshell'  (for page select)
  1503.  
  1504.      Video mode switching will work in non-386 computers but the previous
  1505.      mode screen contents will not be saved.
  1506.  
  1507.      VW.EXE now asks for a video page or video mode when starting a new VMiX
  1508.      shell or DOS shell with FULL screen (use only page 0, when in 386
  1509.      mode).  It will also ask you if this is to be a REMOTE session and
  1510.      start a VT session if requested.
  1511.  
  1512.      VW will respond to the [Home] key by repainting the menu bar.  On non-
  1513.      386 computers, switching to tasks in different video pages or modes will
  1514.      sometimes not restore the VW menu bar on return to VW, so press [Home]
  1515.      to redisplay.
  1516.  
  1517.  12. Channel 5 is now automatically assigned to LPT1 on boot-up.  Try 'spawn
  1518.      -c5 type c:\autoexec.bat' to test LPT1.  You could also test COM1 or
  1519.      COM2, for that matter, if you replace the 5, above, with a 1 or a 2.
  1520.  
  1521.  13. Startup SYSTEM Options
  1522.  
  1523.      The new command syntax is:
  1524.  
  1525.                VM_BOOT [8086] [286] [low] [high] [text] [ems=] [exclude=]
  1526.                        [egacursor] [cgacursor] [ / [ command ] /... ]
  1527.  
  1528.      where (NOTE abbreviated syntax),
  1529.  
  1530.      the '8086'    option forces 8086 (real mode) operation on 80286/386/486
  1531.                    computers.
  1532.  
  1533.      the '286'     option forces 80286 (real/protected mode) operation on
  1534.                    386/486 computers.
  1535.  
  1536.                    The two commands above manually disable 80386 protected
  1537.                    mode operations (useful for getting around compatibility
  1538.                    problems, on certain computers). 
  1539.  
  1540.      the 'lo'      option inhibits the relocation of VMiX code/data to
  1541.                    extended XMS memory.
  1542.  
  1543.      the 'hi'      option forces the relocation of VMiX code/data to extended
  1544.                    XMS memory, when using 8086 mode on a 80286/386/486.
  1545.  
  1546.      the 'text'    option disables the loading of graphics fonts in 8086
  1547.                    mode to save usable memory.
  1548.  
  1549.      the 'ems='    option allows an EMS segment to be specified for VMiX own
  1550.                    use.  On 386 computers, this is not needed since VMiX
  1551.                    automatically relocates data areas to its own EMS and XMS
  1552.                    areas.  However, VMiX could select the wrong EMS segment,
  1553.                    after scanning for ROMs or RAM in upper memory, and crash.
  1554.                    This option allows a safe upper memory segment to be
  1555.                    manually selected (32Kb of unused size is required).
  1556.                    (ems=ffff, disables VMiX own use of the upper memory EMS
  1557.                    area.)
  1558.  
  1559.      the 'exc='    option allows the user to exclude a block of extended
  1560.                    memory, starting after the first megabyte of conventional
  1561.                    memory, by specifying a size in kilobytes to skip.  This
  1562.                    excluded area will not be touched by VMiX.  The size
  1563.                    specified is the number of 1Kb blocks to exclude.
  1564.                    If VMiX detects a resident XMS memory manager like
  1565.                    HIMEM.SYS, it will directly exclude memory that is already
  1566.                    in use.
  1567.  
  1568.      the 'egacur'  option corrects a video BIOS bug that fails to indicate
  1569.                    that CGA cursor emulation is disabled.
  1570.      the 'cgacur'  option corrects a video BIOS bug that fails to indicate
  1571.                    that CGA cursor emulation is enabled.
  1572.  
  1573.      [ command ]   any valid DOS or VMiX shell commands, separated by a '/'
  1574.  
  1575.      Some EGA/VGA's will display what appears to be a broken VMiX cursor
  1576.      when Shift-Tab is pressed to switch tasks.  To correct this, start
  1577.      VMiX with the command line 'VM_BOOT egacur'.
  1578.  
  1579.  14. The VW menu shell is NOW COMPLETE and greatly improved.  We can now
  1580.      recommend VW for regular use.  VW can be used to start other programs
  1581.      or to set VMiX options.  VW is a multiple thread environment (like OS/2).
  1582.  
  1583.  15. On systems with EGA/VGA, an additional 96Kb of DOS program space is
  1584.      now available (64Kb in monochrome mode).  To toggle the additional
  1585.      program space ON/OFF, use the VMiX command 'set system -v'.  The
  1586.      default is OFF, when VM_BOOT is executed.  This option will allow
  1587.      large programs (566Kb maximum) to be executed with VMiX (the maximum
  1588.      without this option is about 470Kb).  Even though VMiX uses extended
  1589.      memory in 286/386/486 ATs/PS2s, the user partition size is limited by
  1590.      the address space of DOS, which is now expandable to 736Kb.
  1591.  
  1592.  16. I/O redirection is now fully implemented.  Basically, if you start
  1593.      a process (with 'dosjob'), you can then use the utility DSTAT.EXE
  1594.      (use 'dstat -a' to see assigned channels only) and determine what
  1595.      channels are available to relocate your process to.  Note that
  1596.      available channels are shown as belonging to process 0, the scheduler.
  1597.      You can also use 'assign' to create a new channel to a serial port
  1598.      (SRCSINK) or to a printer port (CHRSINK).  Lastly, you use the
  1599.      'assign process' syntax to assign a new channel to your executing
  1600.      process.  The original channel of the process will remain available
  1601.      to restore the process back to its original I/O state (See TECHREF.DOC).
  1602.  
  1603.  
  1604. Today VMiX is 100Kb of code and 40Kb of Kernel data. 75% Microsoft C and
  1605. 25% MASM.  VMiX is (C) Copyrighted 'try before you purchase software'.
  1606. This gives us wide distribution for a low cost, thus keeping your purchase
  1607. price also low.
  1608.  
  1609.  
  1610. ----------------------------------------------------------------------------
  1611.  
  1612. When you are ready to register your version, or require:
  1613.      pricing for support, 
  1614.      programming interface documentation,
  1615.      the new printed manual,
  1616.      the source code,
  1617.      site licensing,
  1618.      corporate pricing,
  1619.      or other information, please contact us.
  1620.  
  1621.                                   Enjoy exploring VMiX and thanks
  1622.                                   for supporting its development,
  1623.  
  1624.                ComSoft
  1625.           Post Office Box  36             BBS    (714)  720-1139 (24 Hrs.)
  1626.     Corona del Mar, California  92625    VOICE   (714)  720-1214 (8-6pm PDT)
  1627.  
  1628.